home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 8: LINUX Games / Linux Cubed Series 8 - LINUX Games.iso / games / video / pictetri.src / pictetri / pictetris-src / README < prev    next >
Text File  |  1995-12-23  |  7KB  |  204 lines
  1.       Pictetris for Linux - Written by Mike Taylor and Arturo Espinosa.
  2. '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
  3. Compiling:
  4. ''''''''''
  5.     First of all, you may want to edit the file pictetris.h 
  6.     to configure your game:
  7.  
  8.     The first section declares the position and names of the
  9.     files Pictetris will use.
  10.     The second one is used to declare the keys you are 
  11.     actually going to use during game play.
  12.  
  13.         Then, just type make at the pictetris home directory.
  14.  
  15. Execution:
  16. ''''''''''
  17.     You need to be root in order to run Pictetris :( (this is
  18.     a very bad problem with SVGAlib).  The first time, type
  19.     pictetris at the shell to run the game.  If you save your
  20.     options, then a little script file called pict will be 
  21.     created    and you may want to call Pictetris with this file
  22.     there on.
  23.  
  24. The options:
  25. ''''''''''''
  26.     At the beggining of the game, you will get a menu displayed
  27.     which will present the following options:
  28.     
  29.     Black BG.- Some people think that the picture presented in
  30.                 the background may be a little annoying, so I
  31.         implemented this option for them.
  32.         
  33.     Sound.- When you make a complete line, the computer will
  34.             produce a beep.  If you don't like this, just turn
  35.         it off.
  36.         
  37.     Next-piece box.- When playing, a little box at the top
  38.             left with the next piece to drop is displayed
  39.         (which is a great advantage because you can 
  40.         anticipate your next move).  If you feel like this
  41.         is cheating, you can turn it off.
  42.         
  43.     Random lines.- This is the number of random lines that will
  44.             appear at the beggining of the game (lots of blocks
  45.         dispersed all over from the bottom of the playing
  46.         area to the number of lines you specified).
  47.         
  48.     Level's speed.- You may select the speed at which the pieces
  49.             will fall when you start playing (20 = fastest).
  50.         
  51.     Free falling pieces.- The number you specify here will be
  52.             the number of pieces that will fall at the start of
  53.         the game at random.  You won't be able to control
  54.         these ones.
  55.         
  56.     Keep config.- This will create a shell script named pict on
  57.             the current directory with all the options you have
  58.         selected.
  59.         
  60.         View scores.- Choose this one to take a look at the best
  61.             games recorded.
  62.         
  63.      Continue.- Starts the game.
  64.     
  65.     Quit.- Return to the shell.
  66.  
  67.     To select any option from the menu, just press the red letter
  68.     belonging to it.  All the options can be set from the command
  69.     line:
  70.  
  71.         pictetris [ -s ] [ -S ] [ -n ] [ -b ] [ -B ] [ -f# ] [ -r# ] [ -l# ]
  72.  
  73.      -s: show scores
  74.      -S: No sound (sometimes annoying)
  75.      -n: No next-piece box :(
  76.      -b: rotate clockwise
  77.      -B: black background
  78.      -f: free falling pieces
  79.      -r: random lines
  80.      -l: starting speed
  81.      
  82. The playing screen:
  83. '''''''''''''''''''
  84.     When you press C at the options menu, you enter in the playing
  85.     screen, which is divided as follows:
  86.     
  87.     - To the center, you get a big vertical rectangle which is the
  88.       playing area.
  89.     - To the right of the playing area, there is a small square which
  90.       gives you information about the game:
  91.       
  92.       Challenge.- its the sum of the number of random lines and
  93.                   free falling pieces plus the game speed.
  94.       
  95.       Score.- your current score.
  96.       
  97.       Pieces.- the number of pieces that have dropped.
  98.       
  99.       Levels.- the number of lines you have completed.
  100.       
  101.     - If you turned the option of <Next-piece box> on, an additional
  102.       box to the left of the playing area which will tell you the
  103.       type and position of the piece next to come.
  104.       
  105.     You may pause the game at any time with the key defined in 
  106.     pictetris.h as SUSP_KEY (default is P).
  107.     
  108.     You may also quit from your game with the key corresponding
  109.     to QUIT_KEY (default is q).
  110.     
  111.     When your game is finished, you might enter into the high-
  112.     score table if you beat the old high-score with your
  113.     corresponding challenge.
  114.     
  115.     You can also view the high-scores at the end of the game
  116.     by hitting S.
  117.          
  118. The game:
  119. '''''''''
  120.     Well, it is now difficult to find a person who has had contact
  121.     with computers and doesn't know how to play Tetris.  Eventhough,
  122.     I shall give a short description of this now popular game:
  123.     
  124.     The playing area is a box of 10 by 20 which starts getting filled
  125.     with falling pieces.  The pieces are made out of four blocks each
  126.     with the following forms:
  127.     
  128.     []      []  []
  129.     []      []  []  []      []  [][][]  [][]
  130.     [][]  [][]  []  [][]  [][]    []    [][]
  131.                 []    []  []
  132.  
  133.     As each piece starts falling into the box, you can move and
  134.     rotate them so that they fit the best way with the ones that
  135.     have already dropped.  For every piece you drop, you get a
  136.     certain amount of points depending on the piece:
  137.     
  138.                     []  []      []
  139.             [][][]  []  []      []  [][]  []      []
  140.               []    []  [][]  [][]  [][]  [][]  [][]
  141.                     []                      []  []
  142.  
  143.         Points:   1     2     3    3     4     5     5
  144.  
  145.     The only way of making the pieces dissappear is to fill a
  146.     complete (horizontal) line.  As you may think, you can fill
  147.     several lines with one piece, which is more difficult than
  148.     making only one, so you make more points as you complete
  149.     more lines in a drop:
  150.     
  151.      for 1 line:  10 points.
  152.     for 2 lines:  30 points.
  153.     for 3 lines:  60 points.
  154.     for 4 lines: 100 points.
  155.     
  156.     If the playing area gets full, the game is over.  The game
  157.     speed increases little by little at every moment, so it
  158.     will be more difficult to think and put the pieces in the
  159.     best position.
  160.  
  161. Using your own images:
  162. ''''''''''''''''''''''
  163.     The format of the images must be PCX. If the image is larger
  164.     than 320x200 pixels, it will be truncated.
  165.     If you don't want to change the palette of the game, you
  166.     will need to adapt the palette that comes with title.pcx
  167.     to your new image (this palette has adapted pretty well so
  168.     far). You can do this with a good image editor/viewer like
  169.     Satan Paint.
  170.     Finally, you will only need to add the complete path
  171.     and name of your image to the pictpiclist file.
  172.     
  173. The credits:
  174. ''''''''''''
  175.     Thanks to Mike Taylor who programmed Tetris for Terminals
  176.     several years ago (it was impossible for me to locate him,
  177.         but it seems that his e-mail is mirk@warwick.ac.uk... I
  178.     couldn't manage to send him a mail).  I took the main engine
  179.     and structure of his program to create this version. All
  180.     the graphical interfase coding was done by me (Artruo
  181.     Espinosa <arturo@nuclecu.unam.mx>). Thanks to Jon Griffiths 
  182.     <jpg@cs.waikato.ac.nz> for the Jlib library which I used
  183.     for the graphics.
  184.     
  185.     Thanks to Miguel de Icaza for being such a stubborn player
  186.     and keeping me improving the game.
  187.     
  188. The legal position:
  189. '''''''''''''''''''
  190.     The program "pictetris", its visual appearance, its code, its
  191.     documentation, etc., are the intellectual property of both 
  192.     Mike Taylor and Arturo Espinosa.  The program may be freely 
  193.     distributed, copied, modified, re-posted or whatever PROVIDED 
  194.     that the authorship and ownership remains clear, and that no-one 
  195.     makes any money    from it without us knowing.
  196.  
  197. Future plans:
  198. '''''''''''''
  199.     Net support. Super-Tetris? I'll give it a rest for a while and
  200.     continue developping two other games I've always liked. Please 
  201.     send any suggestions or    modifications to:
  202.     
  203.     Arturo Espinosa    <arturo@nuclecu.unam.mx>.
  204.